home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / dllib.arc / ONEXIT.DOC < prev    next >
Text File  |  1986-10-22  |  1KB  |  46 lines
  1.  
  2.  
  3.         NAME
  4.                 onexit -- install a common exit routine
  5.  
  6.         SYNOPSIS
  7.                 onexit(addr);
  8.                 int *addr;      address of function to call
  9.  
  10.  
  11.  
  12.         DESCRIPTION
  13.         This function is used to install a function into the
  14.         common_exit routine.  It may be used to provide a means
  15.         of insuring that one or more operations are performed before
  16.         a program exit.  Note that the installed routine is ONLY
  17.         called if common_exit() is called to invoke it.  Doing
  18.         a standard exit() will NOT call the installed routine.
  19.  
  20.  
  21.         EXAMPLE
  22.  
  23.              void exithandler() {
  24.                   removetick();
  25.                   }                /* insure ticker is removed */
  26.  
  27.              main() {
  28.                    onexit(&exithandler);
  29.                           ..
  30.                           ..
  31.                           ..
  32.                     common_exit();
  33.                     }
  34.  
  35.         N.B.:
  36.             Any function in this Library which does an exit will
  37.             call common_exit.   This includes (but may not be limited to):
  38.                 error()      aabort()       badext()
  39.                 eraok()      exit2dos()     cant()
  40.  
  41.  
  42.  
  43.  
  44.  
  45.         This function is found in SMDLx.LIB for the Datalight Compiler.
  46.